Custom Preset Scripting Examples

NOTE: The Atlas and Atlas Pro do not support Custom Presets and thus these will not be available for projects using these controllers.

Matrix The green randomly scrolling bars from the Matrix film. Show Code

-- seed for the random number generator

property("seed", INTEGER, 0, 0)

-- initialise the random number generator

math.randomseed(seed)

-- generate a random period,active,offset value for each column of the effect

table = {}

local i = 0

while (i < width) do

table[i] = { math.random(1, 3), math.random(4, 10)/10, math.random() }

i = i+1

end

-- ramp-down effect curve lookup

function ramp_down(f,period,active,offset)

f = f/period

f = f+offset

f = f-math.floor(f)

if (f>active) then return 0 else return f/active end

end

-- the pixel function

function pixel(frame, x, y)

local t = frame/frames

local period = table[x][1]

local active = table[x][2]

local offset = table[x][3]

local f = ramp_down(y/height,period,active,1-t+offset)

return 0,255*f,0

end

Colour Rain Similar to Matrix, but the random bars fade between two colours as they drop, also the direction can be set. Show Code

-- seed for the random number generator

property("seed", INTEGER, 0, 0)

property("gradient", GRADIENT, 0.0, 255, 128, 0, 0.5, 255, 255, 255, 1.0, 0, 192, 255)

property("reverse", BOOLEAN, false)

property("rotate", BOOLEAN, false)

-- initialise the random number generator

math.randomseed(seed)

-- generate a random period,active,offset value for each column of the effect

table = {}

local i = 0

local dimension = width

if (rotate) then

dimension = height

end

while (i < dimension) do

table[i] = { math.random(1, 3), math.random(4, 10)/10, math.random() }

i = i+1

end

-- ramp-down effect curve lookup

function ramp_down(f,period,active,offset)

f = f/period

f = f+offset

f = f-math.floor(f)

if (f>active) then

return 0

else

return f/active

end

end

-- the pixel function

function pixel(frame, x, y)

local t = frame/frames

local col = x

local row = y

local rowWidth = width

local colHeight = height

if (rotate) then

col = y

row = x

rowWidth = height

colHeight = width

end

if (reverse) then

col = rowWidth - col - 1

row = colHeight - row - 1

end

local period = table[col][1]

local active = table[col][2]

local offset = table[col][3]

local f = ramp_down(row/height,period,active,1-t+offset)

local c = gradient:lookup(row / colHeight)

return colour.new(c.red * f, c.green * f, c.blue * f)

end

Plasma Generates a classic plasma effect. Show Code

-- return a multi-frequency noise value

function plasma(x, y, x_period, y_period)

local cx = width/2-0.5

local cy = height/2-0.5

return (math.cos(((cx-x)/x_period)*math.pi*2)+

math.cos(((cy-y)/y_period)*math.pi*2))/2

end

-- return a colour for a given noise value

function colour(f)

return (math.sin(f*math.pi*4)+1)/2*255,(math.sin(f*math.pi)+1)/2*255,0

end

-- the pixel function

function pixel(frame, x, y)

-- calculate a noise value

local f = plasma(x,y,width,height)

-- offset the noise to animate the effect

local offset = frame/frames*2

-- lookup the colour for the noise value

return colour(f+offset)

end